INSTRUCTIONS FOR USING THE VOICE BOX 


IF YOU HAVE A DISK DRIVE: 


Plug the ALIEN GROUP Voice Box for Atari into the 
Disk Drive. 

Put in the Alien Disk. 

Switch-on the power with the Basic cartridge in place. 
If you have 16K memory, type \&UN "D:VB \ . 

If you have 32K memory or more, type 
Follow the prompts. 


IF YOU HAVE A PROGRAM RECORDER: 


Insert the cassette the right way up according to 
the amount of RAM you have, rewinding it if necessary. 
Plug in you r Basic cartridge. 

Type ]pLOAD\ , hit Return, start the recorder, then hit 
Return again. 

Type pRt/ATj . 

Follow the prompts. 


IF ALL ELSE FAILS, READ THE INSTRUCTIONS! 


The ALIEN GROUP Voice Box for Atari plugs into the 
serial port of an Atari 400 or 800 computer, and translates 
computer codes into speech. 

The sound comes out of the TV speaker. The computer 
codes must originate as text strings in a Basic program. 

The programs supplied with the ALIEN GROUP Voice Box 
for Atari translate English text into the phonetic 
codes which constitute its native tongue and also allow you 
to teach it to pronounce words such as names which it did 
not know before. The programs have menus and prompts to 
help you store the pronunciation dictionaries on disk or 
tape. If your computer has 32K or more memory then you can 
also try the Random Sentence Generator, which speaks simple 
grammatical sentences using words you can choose, and you 
can run the version which incorporates the Talking Face, 
which provides some lip-sync animation. 













The ALIEN Voice Box for Atari may be incorporated 
in other Basic programs. Instructions are given in a 
later section which should help you do this. 

HOW TO LOAD THE PROGRAM 

If you are reading this then you have probably 
already tried to run the program and something went, wrong, 
most likely because the program was too big for your 
machine's memory. 

CASSETTE SYSTEMS 

There are two versions of THE ALIEN GROUP Voice Box 
for Atari, one for computers with 16K of memory and one 
for 32K or more. The smaller version does not incorporate 
the Random Sentence Generator or the Talking Face. Both 
versions start at the very beginning of the tape but on 
opposite sides. 

THE 16K VERSION After loading the program, type RUN. 
After a few moments a prompt will appear inviting you to 
set up the cassette with the pronunciation dictionary. 

The dictionary supplied is the next file on the tape so 
you can just type \ D Retur n If, later on, you add to the 
dictionary you would at this point insert the cassette 
with your dictionary, and type [D Return One other 

alternative is to type \ P Return[ . This tells the program 
to use the bare phonetic dictionary that w^as already loaded 
along with program. 

After the dictionary is loaded the program will tell 
you to unplug the program recorder and plug in the Voice 
Box. You can then type in sentences and have the machine 
speak them. 

CA SSETTE VERSION FOR 32K OR MORE The loading 
procedure is identical to that for the 16K version until 
you come to try the Random Sentence Generator. This 
requires that you load a file containing the words to be 
used in the sentences. The next file after the pronunciation 
dictionary will do to start. You will be able to alter 
the words and add your own, but you must begin with some wo 
of each type. 
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OTHER POINTS FOR TAPE USERS 


The cassette supplied is write-protected so if you 
want to use it to save dictionaries or random word lists 
you must first stick tape over the protect tab holes. 

A bug in the Atari operating system (still unfixed 
as of march 1982) requires that you type /LPR . / before doing 
a save. This causes an error message which you should ignore. 
If you want to modify or copy the program you must remember 
to do this. 

DISK DRIVE SYSTEMS 

Power up your system in the usual way with an Atari 
disk that contains DOS. 

Insert the ALIEN DISK and type /RUN ■ > b:V 5 /. If you 
have 32K or more type /RUN "D:VBRF /. After a short time 
the program will respond by asking you to specify which 
dictionary. To use one of the supplied dictionaries, 
type a number from 1 to 3 and hit Return. Or, if you 
want to use the basic phonetic codes already loaded 
along with the program, to construct a new dictionary 
from scratch, just hit Return. 

After the dictionary is loaded a message will tell 
you to plug in the Voice Box and hit Return. The Voice Box 
connects to the Disk Drive or the Interface Box. 

How to Use the Voce Box at this point, if all is well, 
a list of options should appear on the screen and you should 
hear the plea "PLEASE TEACH ME TO SPEAK" or VYEHS MAHSTER." 
This is an example of the phonetic spelling into which 
everything must be translated for the Voice Box to speak. 

This translation task can be done by the computer using one 
of the dictionaries. 

HOW TO BUILD UP YOUR OWN DICTIONARY 

Simply type the phonetic spelling followed by /~=J and 
the proper spelling. For example: /SPEK=SPEAK /. You will 

probably see that the computer's memory will soon be 
exhausted since each word must take about ten bytes . The 
trick is to enter word fragments. For instance: /EK=EAK/ 

teaches the program several words: SPEAK, PEAK, LEAK, TEAK 

and probably many more. One might go a step further and 
enter: /E=EA / since this is the general case. Exceptions 
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such as the word "SPEAR" must be entered separately. The 
program automatically gives priority to longer entries. 
The Appendix gives the complete list of phonetic codes. 
These have become something of a standard since Byte 
magazine published articles on using the Votrax SC-01 
chip in fall 1981. 

SPACES AND HYPHENS 


One unique feature of the ALIEN system is that 
phonetic codes and English text may be freely mixed 
without changing modes. When entering phonetic codes, 
it is usua lly best to separate them with hyphens, e.g. 
pHp-A-AY" /. 

If you want to enter a word fragment that only 
applies when it occurs at the beginning of a word then 
you should include a space immediately after the /=/. For 
suffixes, you must use the underline character instead of 
a space because Atari Basic does not recognize spaces at 
the end of a line. One should use prefix definitions 
carefully since exceptions to them must also be entered 
with leading spaces. 

DO YOU REALLY WANT TO DO THIS? 

At some point the program may query -a definition. 

It does this when you are about to make an irreversible 
change. If you respond with an /W/the change will be 
aborted. 

ERASING AN ENTRY 

An entry can be erased by typing /=J followed by 
the word to be removed, e.g. /-WORD/. 

SAVING A DICTIONARY 

After you type /*£> /, the program will ask you to 
name the dictionary file that is to receive the data. If 
you type (for example) /SWAHILI /,a disk file name DSWAHILI 
will be created. Do not type a number unless you want to 
overwrite one of the existing dictionaries. When you next 
run the program, you would recall your dictionary by 
responding with /SWAHILI / instead of a number. 
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VOICE PITCH CONTROL 


You can make THE ALIEN Voice Box for Atari talk in 
one of four pitch registers. At the begining of each line 
of speech it resets itself to the next to lowest. You can 
shift to a higher register by making the first character 
in the line a slash. Two slashes will take it to the 
highest pitch. If you want to turn Beethoven over in his 
grave, type: 

//DE. DE. DE... \\DEEEE 

This is about the limit of the musical posibilities of 
the ALIEN Voice Box. 

THE PHRASE MEMORIES 

This little feature was added to save your having 
to type in the same thing twice. There are two memories 
which can each save or recall a single line of text. At 
the end of a line you want to save, add /> 1 / or fc>2 / . At 
any other time you can recall that line by typing /l<c / or 

/2c7- 

THE SPEED CONTROL KNOB 

This simultaneously affects the speed and pitch of 
the speech, and gives a variety of voice personalities, 
particularly when used in conjunction with the \ and/ pitch 
controls. 

DICTIONARY SPACE AND THE LIMIT OF MEMORY 

If you want to build up a very large vocabulary and 
you have more than 32K of RAM, you must redimension the 
two strings that hold the dictionary. Do this by altering 
the value of VXM in line 3. If you have a 48K system this 
may be as large as 11000. In that case a total of some 
20,000 bytes would be available for storing words. If, on 
the other hand, you need more memory to add features to the 
program then you can reduce VXM. If you make it too small 
then there will be an error halt when loading a dictionary. 

The 16K disk version (program VB) already has VXM 
set as large as possible. 

When you type / *M / to see how much memory has been 
used, the percentage given is referred to VXM. The function 
FRE(O) will tell you how much is left for adding Basic 
statements. 
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THE RANDOM SENTENCE GENERATOR 


After you type /* R / you will be in another part of 
the program where new commands apply. When you first enter 
it the program will ask if you want the standard words or 
the words you saved last time. If there was no last time 
you must of course take the standard words. 

Every time you hit the Return key the ALIEN Voice Box 
for Atari will compose a new random sentence. You can get i 
to repeat the sentence by typing /ft 7. 7J±J will return you 
to the phonetics program with the last sentence spoken saved 
in phrase memory 1. 

TO CHANGE THE WORDS USED FOR RANDOM SENTENCES 

There are nine different types of words - nouns, 
verbs, adjectives, etc. You can add to, or change, the 
words in each group. If you want a particular word to have 
greater chance of being chosen then you should enter it 
twice or more times. Note that the words in a list must be 
separated by commas, and that you are allowed only three 
lines of words. The keyboard will squawk when you get near 
the limit. 

THE TALKING FACE 

This little extra, available only in fhe 32K versions 
of the program, is invoked by typing while in the 

phonetics mode. You can restore the normal full screen 
of text by typing /*T7 at any time. 

HOW TO INCORPORATE THE VOICE BOX IN YOUR OWN BASIC PR OGRAM 

One way of doing this is to load either VB or VBRF, 
and build your own program around it. If you are short of 
memory you can delete lines that you don't need. An 
obvious place to start is with the menus, and vowel and 
consonant lists. 

If you won't be saving a dictionary you can delete 
line 2030 and lines 4000 to 4210. If you don't need to 
see the dictionary, delete 2040 and 5000 to 5060. 

If you won't be changing the dictionary, then lines 
1015 to 1480 can go, but you should in this cas e e nsure 
that no string to be spoken ever includes an {=7. as this 
will mess up the dictionary. 
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Atari Basic sometimes goes wrong if you delete many 
lines from a program, and everything disappears. This 
seems less likely to happen if you run the program at 
frequent intervals. 

Such a stripped down version, intended to be 
incorporated in a larger program, has been included on the 
disk with the name VBS. It is in the list form so that it 
may be merged with another program using the Enter command 
It can read a dictionary from the disk, and pronounce word 
using it. 

The structure of the program is quite simple: 

Lines 3 to 85 load the machine code. 

Line 100 calls the subroutine at 3000 which reads 
a dictionary from disk. 

Lines 131 to 305 (which can be omitted) remind you 
to plug in the Voice Box and verify that it. is ready. 

It then jumps to 4000, where your program would 
normally start. Note that the actual talking is done by 
the subroutine at 1000 which speaks A$. 

This program leaves some 3700 bytes free in a 16K 
disk system. If you need more dictionary space, and your 
program occupies less than 3700 bytes, then you should 
increase VXM in line 3. 

ASSEMBLY LANGUAGE PROGRAMING 

For those select few who write in assembly language 
a file named VB.OBJ is included on the disk. This is a 
relocatable subroutine (assembled at $600) which delivers 
a single byte of data to the Voice Box. This byte should 
be passed in register X. On returning, all registers are 
restored, and no other locations are altered. 

It occupies 95 bytes and executes in about 2.5mS 
if the Voice Box is ready for data, and up to 250mS if it 
is not. The data byte corresponds to the hexadecimal 
column in the list of phoneme codes in the appendix. 

$40, $80 or $CO should be added to raise the pitch. 

Note that most phonemes will make a sound that 
persists until the next phoneme is delivered. 
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In a program using animated graphics it may be 
undersirable for the action to stop while waiting for the 
Voice Box to finish each phoneme. In this case the calling 
program can check if new data is needed before calling the 
delivery subroutine by looking at BIT 4 of $D20F. A 1 
means the Voice Box is still busy with the last byte. At 
the beginning of the program, code $03 (=silence) should 
be delivered unconditionally. This ensures that the Voice 
Box is set up correctly. 


WARRANTY INFORMATION 


THE ALIEN GROUP will repair or replace any part of the 
product which fails due to faulty materials or workmanship 
within one year from the date of purchase. All products 
including disks are thoroughly tested before leaving the 
factory. 

If your ALIEN GROUP Voice Box for Atari should fail, 
send it securely packed, postage prepaid and insured to 
The ALIEN GROUP. A charge of $10.00 will be made to 
cover postage and handling. You may include a check or 
Money Order for this amount, or pay C.O.D. when the product 
is returned. It. is most important when returning goods 
for repair to add a note saying precisely how it has failed. 

If the disk or cassette fails to load when you first 
try it, then you should within 14 days return it to the 
store for a free replacement. Direct customers of The 
ALIEN GROUP may return it to us by mail with 14 days, 
together with a copy of the sales slip for a free exchange. 

Replacement disks and cassettes may be purchased by 
mail from The ALIEN GROUP for $10.00. 
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APPENDIX 


Catalogue of Disk Programs 


If you use DOS to look at the directory of files 
you will see a rather unrevealing list of cryptonyms. 


Here is 

an explanation of that list. 

VB 

Basic program for VOICE BOX for systems with 
only 16K. 

VBRF 

Basic program for VOICE BOX incorporating 

RANDOM sentences and talking FACE, for systems 
with 32K or more. 

D1 

Pronunciation dictionaries. Dl is the largest 
that can be loaded by program VB. 

D2 

D2 spells the words out. 

D3 

D3 is the largest. 

DFWORDS 

Default File of WORDS for Random Sentence 
Generator. 

DWORDS 

Ujsers File of Words for Random Sentence Generator 

VB.OBJ 

Machine language subroutine to deliver one 
phoneme byte. 

VBS 

Stripped down version of Basic program intended 
to be incorported in other programs. Use the 
Enter command to merge VBS with another program. 
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APPENDIX 


Phoneme 

Symbol 

A 

Al 

A2 

AE 

AE1 

AH 

AH1 

AH2 

AW 

AW1 

AW2 

AY 

B 

CH 

D 

DT 

E 

El 

EH 

EH1 

EH 2 

EH 3 

ER 

F 

G 

H 

I 

II 
12 
13 
IU 
J 


Example 

D AY 

MADE 

ENABLE 

DAD 

AFTER 

MOP 

FATHER 

HONEST 

CALL 

LAWFUL 

SALTY 

DAY_ 

BAG 

CHIP 

PAID 

BUTTER 

MEET 

BE_ 

GET 

HEAVY 

ENLIST 

JACKET 

BIRD 

FAST 

GET 

HELLO 

PIN 

INHIBIT 

INHIBIT 

INHIBIT 

Y OU 

JUDGE 


COMBINATIONS 


Al-AY-Y 

AH1-EH3-Y 

UH3-AH2-Y 

AH1-UH3-U1 


PHONEME LIST 


Time Hex- Phoneme 

(mS) Code Symbol 


185 20 K 

103 06 L 

7105 M 

185 2E N 

103 2F NG 

250 24 O 

146 15 OI 

71 08 02 

250 3D 00 

146 13 001 

90 30 P 

65 21 PA 0 

71 OE PA1 

71 10 R 

55 IE S 

46 04 SH 

185 2C 

121 3C T 

185 3B TH 

121 02 THV 

71 01 U 

59 00 U1 

146 3A UH 

103 ID UH1 

71 1C UH2 

71 IB UH3 

18 5 27 V 

121 OB W 

80 OA Y 

55 09 Y1 

59 36 Z 

47 1A ZH 


Time Hex- 
Example (mS) Code 


TRICK 

LAND 

MAT 

SUN_ 

THING 

MORE 

ABOARD 

FOR 

BOOK 

LOOKING 

PAST 

NO SOUND 

NO SOUND 

RED 

PASS 

SH OP 

NO SOUND 

TAP 

THIN 

THE 

MOVE 

Y OU 

CUP 

UNCLE 

ABOUT 

MISSION 

VAN 

WIN 

ANY_ 

YARD 

ZOO 

AZURE 


80 19 

103 18 

103 OC 

80 OD 

121 14 

185 26 

121 3 5 

80 34 

185 17 

103 16 

103 25 

47 03 

185 3E 

90 2B 

90 IF 

121 11 

47 3F 

71 2A 

71 39 

80 38 

18 5 28 

90 37 

185 33 

103 32 

71 31 

47 23 

71 OF 

80 2D 

103 29 

80 22 

71 12 

90 07 


GAME 

TIME 

FIGHT 

COW 


UH3-AH2-U1 

Ol-Ul 

01-UH3-Y 

Y1-IU-U1 


HOUSE 

NOTE 

T OY 

MUSIC 


J should generally by DJ and CH should be TCH 










